Pascal Super Library

home *** CD-ROM | disk | FTP | other *** search

/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / TURB_VIS / TCYBER25 / CYBER.DOC < prev next >

Wrap

Text File | 1994-10-19 | 25KB | 723 lines

╔═[■]═════════════════════════╗ ║ ║ █ ║ Turbo Vision CyberTools 2.5 ║ █ ║ (C) 1994 Steve Goldsmith ║ █ ║ All Rights Reserved ║ █ ║ ║ █ ║ DEMOWARE VERSION ║ █ ║ ║ █ ╚═════════════════════════════╝ █ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ OVERVIEW Turbo Vision (tm) is a great object-oriented framework for building DOS applications. Unfortunately, fonts, graphics, 256 color animation, ANSI terminals, generic database browsers and other 'drop-in' tools are not included. You could spend a small fortune on commercial or Shareware libraries just to find out you bought a disjointed set of TV gizmos and gadgets in beta testing. Your DOS Real and DPMI applications need a competitive edge to be successful. Turbo Vision CyberTools gives you that edge by creating professional applications with a low cost and flexible set of tools. Powerful tools are important, but applications that show you how to use the library are equally important. All too often you get a 'powerful' commercial library with 100 line demo programs that barely scratch the surface (or gasp, have error handling). With CyberTools you get full blown applications and not empty skeleton code. CyberFont (tm) provides fonts, graphics, PCX images, sprites, bit map animation and DAC palettes. CyberFont is simply the fastest and easiest to use Turbo Vision graphics enhancement around. Now with new Windows (tm) look for CyberFont apps! CyberAnimation is a fast 256 color animation player, creator and PCX importer/exporter. Animation format faster and smaller than FLI format! Great for multimedia or game applications. CyberBase for Paradox Engine 3.x includes a new generic table editor window, generic table and index create, memo editor, cut and paste fields, easy engine configuration, automatic locks and validation. CyberTerm for Async Professional 2.x is a professional multi-session async communications application with CyberScript (tm) script language, IDE and supporting tools. If you were disappointed with other Turbo Vision terminals then CyberTerm is for you! CyberTools is fully supported by environments like Windows 3.x, Windows 95, NT, OS/2 and networks which are capable of running DOS boxes in real and 16 bit DPMI mode. You can have multiple applications with multiple graphics and fonts running at the same time. MISSION STATEMENT CyberTools is currently being used all over the world in everything from embedded systems to foreign language products. It is important for me to produce the most powerful, flexible and low cost product for the end user. REQUIREMENTS IBM PC or 100% compatible MS DOS compatible OS Borland Pascal 7.x or Turbo Pascal 7.x with Turbo Vision 2.x VGA display for CyberFont apps and CyberAnimaton app Borland Paradox Engine 3.x for CyberBase app Turbo Power Async Professional 2.x for CyberTerm app Working knowledge of Pascal, OOP and Turbo Vision LICENSE AGREEMENT PLEASE FEEL FREE TO (i) UPLOAD THIS SOFTWARE TO ANY ELECTRONIC BULLETIN BOARD, (ii) DEMONSTRATE THE SOFTWARE AND ITS CAPABILITIES OR (iii) GIVE COPIES TO POTENTIAL USERS, SO THAT OTHERS MAY HAVE THE OPPORTUNITY TO OBTAIN A COPY FOR USE IN ACCORDANCE WITH THE LICENSE TERMS CONTAINED IN THIS FILE. NOTICE TO USER: CAREFULLY READ THE FOLLOWING LEGAL AGREEMENT. YOU MUST PROMPTLY BUY THE PRODUCTION VERSION OF THE SOFTWARE PROVIDED WITH THIS AGREEMENT (THE "SOFTWARE") BY COMPLETING AND FORWARDING TO STEVEN P. GOLDSMITH THE ORDER.DOC OR ORDER.TXT FILE CONTAINED IN THE SOFTWARE. 1. LICENSE GRANT. Steven P. Goldsmith grants to you, as an individual, a non-exclusive right to use one copy of the SOFTWARE associated with this license for personal use on your computer. This license to use the SOFTWARE is conditioned upon your compliance with the terms of this Agreement. You are entitled to evaluate the software on a royalty free basis for thirty days. Use after the thirty day evaluation period is further conditioned upon payment of the license fee specified in ORDER.DOC or ORDER.TXT file. You agree you will only copy the SOFTWARE as necessary to use it in accordance with this license. 2. COPYRIGHT. The SOFTWARE is protected by United States copyright law and international treaty provisions. You acknowledge that no title to the intellectual property in the SOFTWARE is transferred to you. You further acknowledge that title and full ownership rights to the SOFTWARE will remain the exclusive property of Steven P. Goldsmith or its suppliers, and you will not acquire any rights to the SOFTWARE except as expressly set forth in this license. You agree that any copies of the SOFTWARE will contain the same proprietary notices which appear on and in the SOFTWARE. 3. REVERSE ENGINEERING. You agree that you will not attempt to reverse compile, modify, translate, or disassemble the SOFTWARE in whole or in part. 4. LIMITED WARRANTY. Steven P. Goldsmith warrants that the SOFTWARE will perform substantially in accordance with the accompanying written materials for a period of ninety (90) days from the date of purchase. Any implied warranties relating to the SOFTWARE are limited to ninety (90) days. 5. STEVEN P. GOLDSMITH DOES NOT WARRANT THAT THE SOFTWARE IS ERROR FREE. STEVEN P. GOLDSMITH DISCLAIMS ALL OTHER WARRANTIES WITH RESPECT TO THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES OR LIMITATIONS ON HOW LONG AN IMPLIED WARRANTY MAY LAST, OR THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM JURISDICTION TO JURISDICTION. 6. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. IN NO EVENT SHALL STEVEN P. GOLDSMITH OR ITS SUPPLIERS BE LIABLE TO YOU FOR ANY CONSEQUENTIAL, SPECIAL, INCIDENTAL OR INDIRECT DAMAGES OF ANY KIND ARISING OUT OF THE DELIVERY, PERFORMANCE OR USE OF THE SOFTWARE, EVEN IF STEVEN P. GOLDSMITH HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT WILL STEVEN P. GOLDSMITH'S LIABILITY FOR ANY CLAIM, WHETHER IN CONTRACT, TORT OR ANY OTHER THEORY OF LIABILITY, EXCEED THE LICENSE FEE PAID BY YOU, IF ANY. 7. ENTIRE AGREEMENT. This is the entire agreement between you and Steven P. Goldsmith which supersedes any prior agreement or understanding, whether written or oral, relating to the subject matter of this license. WHAT YOU GET WHEN YOU BUY THE PRODUCTION VERSION Documented library and application source code. Document describing how CyberFont works, CGF and SNP file formats, etc. Ability to write field and memo BLOB modifications with CyberBase app. Ability use CyberScript GETBLOCK and DOWNLOADZMODEM commands. Ability to use boolean and math functions with all variable types. 50 bit map fonts. Fast support from author using Internet. Upgrades at a nominal charge. No royalties for your run-time code. WHAT IT COSTS Turbo Vision CyberTools is still only $25.00 US plus shipping. That's less than the price of programming books, magazine subscriptions and most Turbo Vision tools that do not even come close to CyberTools! Print ORDER.DOC for IBM PC character printers or ORDER.TXT for ASCII printers. Contact me for current upgrade pricing. HOW TO CONTACT CYBERTOOLS AUTHOR Please report any support questions, problems, suggestions, etc. to me via GEnie as S.GOLDSMITH2, via Internet as S.GOLDSMITH2@GENIE.GEIS.COM, voice phone (813) 925-1064 or mail SASE to: Steve Goldsmith 2805 Jamaica Street Sarasota, FL 34231 USA INSTALLING AND COMPILING APPLICATIONS Copy the ZIP file into a test directory and PKUNZIP *. Overwrite all the APP.INC files in each ZIP. Later you can just install the individual apps you want. See application source for IDE paths. Help files (??HELP.TXT) need to be compiled with Turbo Vision Help Compiler 1.1 (\BP\EXAMPLES\DOS\TVDEMO\TVHC.PAS) that comes with TVDEMO. CYBER DOC contains info about CyberTools. COMMON ZIP contains common units used by all applications. CYANI ZIP contains CyberAnimation application CYBASE ZIP contains CyberBase application CYEDIT ZIP contains CyberEdit application CYGAME ZIP contains CyberGame application CYGRAPH ZIP contains CyberGraph application CYTERM ZIP contains CyberTerm application. FONTS ZIP contains CGF fonts for CyberFont applications. CYBERTOOLS OBJECT TREE CyberTools takes advantage of OOP programming techniques to create reusable modular code. Take some time and study the tree to give you an overview of the CyberTools object hierarchy. ─Objects ├──Root │ ├──AbstractPort │ │ └──UartPort │ │ └──ctUartPort │ └──AbstractProtocol │ ├──AsciiProtocol │ │ └──ctAsciiProtocol │ ├──KermitProtocol │ │ └──ctKermitProtocol │ ├──XmodemProtocol │ │ ├──ctXmodemProtocol │ │ └──YmodemProtocol │ │ └──ctYmodemProtocol │ └──ZmodemProtocol │ └──ctZmodemProtocol └──TObject ├──TAnsiEmu ├──TChrGenFile ├──TCollection │ └──TSortedCollection │ └──TPhoneCollection ├──TLabelNode ├──TpxeField ├──TpxeFieldDesc ├──TpxeRecord ├──TReadPCXFile │ ├──TDecodePCXFile2 │ │ └──TPCXToChrTable │ └──TDecodePCXFile256 ├──TReadSnpFile │ ├──TDecodeSnpFile │ └──TDecodeSnpScr ├──TScriptCompile ├──TScriptEng ├──TScriptNode ├──TStackNode ├──TTermRec ├──TVarNode ├──TView │ ├──TBackView │ ├──TChrEditView │ ├──TChrSetEditView │ ├──TChrSetView │ ├──TCluster │ │ ├──TCheckBoxes │ │ │ └──TCheckBoxesCF │ │ ├──TMultiCheckBoxes │ │ └──TRadioButtons │ │ ├──TMsgButtons │ │ └──TRadioButtonsCF │ │ └──TMsgButtonsCF │ ├──TColPalView │ ├──TEditor │ │ └──TFileEditor │ │ └──TCyFileEditor │ ├──TFileInfoPane │ │ └──TInfoPane │ ├──TGroup │ │ ├──TDesktop │ │ ├──TProgram │ │ │ └──TApplication │ │ │ ├──TCyberAni │ │ │ ├──TCyberBase │ │ │ ├──TCyberEdit │ │ │ ├──TCyberGame │ │ │ └──TCyberTerm │ │ └──TWindow │ │ ├──TDialog │ │ │ ├──TChrEditDlg │ │ │ ├──TChrSetDlg │ │ │ ├──TChrSetEditDlg │ │ │ ├──TDirWindow │ │ │ ├──TDriveDlg │ │ │ ├──TGameDlg │ │ │ ├──TGameOptsDlg │ │ │ ├──TPalDlg │ │ │ ├──TPCXSNP │ │ │ ├──TpxeCreateDialog │ │ │ ├──TpxeEngineCfg │ │ │ ├──TpxeIndexDialog │ │ │ ├──TpxeKeyDialog │ │ │ ├──TpxeMemoEdit │ │ │ ├──TpxeTableWin │ │ │ ├──TScrOptsDlg │ │ │ ├──TSnipDialog │ │ │ ├──TStrListDlg │ │ │ ├──TTermConfigDlg │ │ │ ├──TTermGenDlg │ │ │ ├──TToolBarDlg │ │ │ └──TWinSizeDlg │ │ ├──TEditWindow │ │ │ └──TCyEditWindow │ │ ├──TLogWin │ │ └──TTermWin │ ├──TIconView │ ├──TInputLine │ │ ├──TDirWinLine │ │ └──TpxeTableLine │ ├──TListViewer │ │ └──TListBox │ │ ├──TpxeFieldListBox │ │ └──TSortedListBox │ │ └──TTermListBox │ ├──TpxeTableView │ ├──TScroller │ │ ├──TAnsiTerm │ │ ├──TOutlineViewer │ │ │ └──TDirectoryViewer │ │ │ └──TDirViewer │ │ └──TTextDevice │ │ └──TTerminal │ │ └──TLogTerm │ ├──TSpriteView │ │ ├──TBombView │ │ ├──TExpView │ │ ├──THeadView │ │ ├──TShipView │ │ ├──TShotView │ │ └──TUfoView │ └──TStaticText ├──TWritePCXFile │ ├──TEncodePCXFile2 │ │ └──TChrTableToPCX │ └──TEncodePCXFile256 └──TWriteSnpFile CRITICAL ERROR HANDLER I have installed a new critical error handler in all apps. All apps will now pop up a message box with the error message and allow idle processing to continue. This is a must for CyberTerm which can have multiple communication processes running at the same time. CyberFont apps use page flipping for animation. If the error pops up when the screen is not on page 0 then you will not see the standard message line. All that it takes to use the CyberTools error handler is the following in your main program: { Main app. } var MyApp : TSomeApp; begin MyApp.Init; SysErrorFunc := AppSystemError; { <== add this for new handler} MyApp.Run; MyApp.Done end. The issue of being in a non-reentrant state when the handler is called has been raised. I have not had any problems accessing empty floppy drives, locked files on a net work, printer turned off, etc. You can remove my SysErrorFunc if you wish to use the default handler in DRIVERS.PAS. If you do find a way to crash it let me know! The only way I know would be in a TSR or ISR, but who is going to use TV for a TSR? CYBERFONT FEATURES Easily add CyberFont's functionality to new or existing programs. You DO NOT have to use a different coordinate system (BGI), special object types (GView, GWindow, etc.) or BGI drivers like other slow graphic enhancements. CyberFont is 100% compatible with all your current and future TV applications. CyberFont doesn't require you to modify or patch the RTL, so it will also be compatible with future TV, RTL and 32 bit protected mode releases! Low level access to the VGA's CRT, attribute, graphics and sequencer controllers is provided for VGA hackers who like to tinker. All assembler code is in BASM (Built in Assembler), so no external assembly is needed. BIOS routines are also included for the highest level of compatibility. Fast graphics primitives included for pixels, lines and ellipses. Do graphic pie charts, bar graphs, line graphs, etc. Load, modify and save fonts. Allows unlimited selection of fonts for text mode. Create graphic radio buttons, check boxes and other graphic controls like Nortons (tm) and Central point (tm) DOS products use. Load, modify, save and view .PCX images in text mode! Use your favorite paint program or CyberEdit to edit fonts. 640 X 400 pixel resolution in text mode to eliminate gaps between characters. This allows uniform backgrounds, sprite animation, bit maps and graphics not possible in standard text mode. Access all 8 font tables available with the VGA instead of the 2 provided by BIOS. CyberFont applications can use page flipping for flicker free animation and consistent timing. This is a must for any serious animation on the VGA. Flicker free DAC palette changes, fades and attribute controller access. Load and save fonts, graphics, palettes, configuration, etc. using TV streams. You can also save your desk top on the same stream! Shell to DOS or use any VGA graphics mode while preserving the desk top, font and palette. New CYBERAPI shows you an example of overlaying VGA primitives in a DLL. CYBERFONT APPLICATIONS All CyberFont applications include a graphic desk top, load and/or save fonts and PCX images, configuration streams and context sensitive help. CYEDIT.PAS is a powerful 8 X 16 font editor. Edit multiple fonts from multiple font tables at the same time. Uses graphic tool bar and custom character selector. CYGRAPH.PAS is a graphics application utilizing a resizable graphics window for lines, ellipses, rectangles, business X,Y type line graphs and a star field simulation. Configuration file compatible with CyberEdit 2.5. CYGAME.PAS is a multi-level 'Invaders' type arcade game using sprites, bit map animation, PC speaker sound and custom game controls. Turn page mode on in Options|Screen if the game animation runs too fast on your machine. Uses custom configuration file to save control settings along with standard app data. CYBERANIMATE FEATURES Play 256 color Snip (.SNP) animation files created with a ComputerEyes/RT frame grabber, PCX files or other 256 color animation formats that can be decoded to screen or memory. Export single movie frames as PCX files. Import a group of PCX files to create a Snip movie file. Decoding and play back faster than many commercial software schemes used under DOS and Windows. This allows slower 286 and 386 machines to enjoy animation that could only be played on newer/faster machines before. Snip files are typically 30% smaller than the same FLI encoded file. Snip files will appeal to multimedia and game programmers. CYBERANIMATE APPLICATION CYANI.PAS allows you to play Snips, export current frame as a PCX or create a Snip from PCX files. You can also view 256 and 2 color PCX files. Includes CyberFont desk top and smooth video mode changes. CYBERBASE FEATURES A powerful new Paradox table editor allows you to easily create single and multi-user database applications. Just open a table cursor on any index and let the editor do the rest. No need to hard-code table structures or use error prone scripts like many other database libraries. Create Paradox tables in minutes without writing any code! Add or delete indexes on the fly. Fields are validated to insure database integrity. Use your own validators by overriding the method that creates basic validators. Memo editor is included with provisions for other custom blob editors. Cut and paste from the standard clip board! Use it to import or export memo BLOBs and all standard field types. Explicit record locking with retry is automatically used if the engine is initialized for network use. Full control of engine configuration allows you to make changes without recompiling application. Use CyberFont to add graphics or charts to your database applications! IMPORTANT: Remember to add TCursor.getTableHandle method to the Data Base Framework in \BP\PXENGINE\PASCAL\SOURCE\OOPXENG.PAS. This allows PX Browse access to TCursor's private table handle tabH. PX Browse can then search on the primary index regardless of what index the table is opened on. SEARCH OOPXENG.PAS FOR 'searchIndex' RIGHT AFTER: function searchIndex(keyRec: PRecord; mode: PXSearchMode; fldCnt: Integer): Retcode; virtual; ADD: function getTableHandle : TableHandle; SEARCH OOPXENG.PAS FOR 'TRecord methods' RIGHT BEFORE: ************************************************************************** TRecord methods ************************************************************************** ADD: function TCursor.getTableHandle : TableHandle; begin getTableHandle := tabH end; CYBERBASE APPLICATION CYBASE.PAS is a full featured generic data base application using PX Edit unit to edit multiple Paradox tables on single user or network systems. Generic table and index creation fully supported. Add a report generator and you will have one powerful generic data base tool! CYBERTERM FEATURES CyberTerm provides a complete ANSI/VT100 terminal package. Run multiple terminal windows and protocols at the same time! Run a Z modem download and play a door game on multiple BBSs. You can have up to four serial devices operating at the same time. All the standard Async Professional features: 115K baud, 16550 UART FIFO buffering, all protocols Z/Y/X/K/A, hardware and software flow control, COM1 - COM8, etc. ANSI/VT100 emulation object includes support for IBM keyboard remapping. Fast ANSI terminal window with virtual buffering up to 132 column X 1000 lines and Smart Cursor Tracking (tm). Size not limited to 132 X 1000. Local echo with ANSI emulation. Capture file in raw (include ANSI codes) or cooked (strip ANSI codes) mode. This makes it easy to snag your favorite BBS screens or entire sessions. Log windows to track communication events from multiple sessions. Display as little or as much information as you like. Great for debugging async applications or tracking connect time for cost analysis. Phone book with many configuration options. Just double click on entry to dial modem or connect to a local device. Phone book is saved with configuration stream to allow multiple phone books to exist. CyberScript (tm) is a powerful high level script language which allows the automation of many on-line tasks. Features: Numeric variable types in addition to string type Up to 16,000 variables Up to 16,000 level deep call nesting Basic math functions Boolean functions and other flow control commands Fast compile times (13000 lines a minute on a 386/33 in 16 bit DPMI). Each line can consist of a blank, a comment (;), or a command. You can also indent comments, commands and params. The format for a comment is: ;This is a comment The format for a command is: COMMAND PARAMS Examples: String FirstName Assign FirstName,'Steve' WaitFor 'First Name:' Send FirstName CyberScript currently supports STRING, LONGINT and DOUBLE user definable variable types. A variable must be declared prior to referencing it in your script. The format for declaring a variable is: String FirstName LongInt MessageCount Double SellPrice Commands like WAITFOR and SEND can handle all variable types. For example if you want to send a DOUBLE out the port use: Assign SellPrice,50000.00 Assign Tax,5000.00 Add SellPrice,Tax Send SellPrice Will result in the string '55000.00' being sent out the port. Commands like GETRESP only accept STRING and others like WAITFORSECS except only LONGINT. Constants can used in place of variables for many commands: Send #27 Can be used to send an escape character or other non-editable character. Numeric constants can also be used: Add MessageCount,1 Mul Tax,.05 CyberScript command table ───────────────────────── ┌──────────────┐┌────────────────┐┌───────────────┐ │COMMAND ││PARAM TYPE ││VAR TYPE │ └──────────────┘└────────────────┘└───────────────┘ ┌──────────────┐┌────────────────┐┌───────────────┐ │WAITFOR ││constant/var ││all │ │SEND ││constant/var ││all │ │GETRESP ││var ││string │ │GETBLOCK ││constant/var ││string │ │IF= ││var,constant/var││all │ │IF<> ││var,constant/var││all │ │IF< ││var,constant/var││all │ │IF> ││var,constant/var││all │ │IF<= ││var,constant/var││all │ │IF>= ││var,constant/var││all │ │ASSIGN ││var,constant/var││all │ │ADD ││var,constant/var││all │ │SUB ││var,constant/var││longint,double │ │MUL ││var,constant/var││longint,double │ │DIV ││var,constant/var││longint,double │ │WAITFORSECS ││constant/var ││longint │ │CALL ││label ││ │ │RETURN ││ ││ │ │GOTO ││label ││ │ │LABEL ││label name ││ │ │CAPTUREAPP ││constant/var ││string │ │CAPTURENEW ││constant/var ││string │ │DOWNLOADZMODEM││constant/var ││string │ │STRING ││var name ││ │ │LONGINT ││var name ││ │ │DOUBLE ││var name ││ │ │WAITFORSEPCHAR││constant/var ││string │ │ADDGETDELIM ││constant/var ││string │ │INIT ││ ││ │ │DIAL ││ ││ │ │HANGUP ││ ││ │ │LOGON ││ ││ │ │LOGOFF ││ ││ │ │END ││ ││ │ └──────────────┘└────────────────┘└───────────────┘ CYBERTERM APPLICATION CYTERM.PAS is a complete ANSI terminal with point and shoot operation. With the addition of the CyberScript compiler you can create powerful vertical market applications. Realestate MLS systems, Internet and other services are just ripe for a CyberTerm app. You could also parse input directly into a Paradox table instead of parsing a capture file. Drop in a Paradox browser and view/edit the data real-time!